home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / X11 / xset.z / xset
Text File  |  1998-10-20  |  15KB  |  331 lines
  1.  
  2.  
  3.  
  4.      XXXXSSSSEEEETTTT((((1111))))            XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....3333))))             XXXXSSSSEEEETTTT((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           xset - user preference utility for X
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.           xxxxsssseeeetttt [-display _d_i_s_p_l_a_y] [-b] [b on/off] [b [_v_o_l_u_m_e [_p_i_t_c_h
  13.           [_d_u_r_a_t_i_o_n]]] [[-]bc] [-c] [c on/off] [c [_v_o_l_u_m_e]] [[-+]fp[-
  14.           +=] _p_a_t_h[,_p_a_t_h[,...]]] [fp default] [fp rehash] [[-]led
  15.           [_i_n_t_e_g_e_r]] [led on/off] [m[ouse] [_a_c_c_e_l__m_u_l_t[/_a_c_c_e_l__d_i_v]
  16.           [_t_h_r_e_s_h_o_l_d]]] [m[ouse] default] [p _p_i_x_e_l _c_o_l_o_r] [[-]r
  17.           [keycode]] [r on/off] [s [_l_e_n_g_t_h [_p_e_r_i_o_d]]] [s
  18.           blank/noblank] [s expose/noexpose] [s on/off] [s default] [s
  19.           activate] [s reset] [q]
  20.  
  21.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  22.           This program is used to set various user preference options
  23.           of the display.
  24.  
  25.      OOOOPPPPTTTTIIIIOOOONNNNSSSS
  26.           ----ddddiiiissssppppllllaaaayyyy _d_i_s_p_l_a_y
  27.                   This option specifies the server to use; see _X(_1).
  28.  
  29.           bbbb       The bbbb option controls bell volume, pitch and
  30.                   duration.  This option accepts up to three numerical
  31.                   parameters, a preceding dash(-), or a 'on/off' flag.
  32.                   If no parameters are given, or the 'on' flag is
  33.                   used, the system defaults will be used.  If the dash
  34.                   or 'off' are given, the bell will be turned off.  If
  35.                   only one numerical parameter is given, the bell
  36.                   volume will be set to that value, as a percentage of
  37.                   its maximum.  Likewise, the second numerical
  38.                   parameter specifies the bell pitch, in hertz, and
  39.                   the third numerical parameter specifies the duration
  40.                   in milliseconds.  Note that not all hardware can
  41.                   vary the bell characteristics.  The X server will
  42.                   set the characteristics of the bell as closely as it
  43.                   can to the user's specifications.
  44.  
  45.           bbbbcccc      The bbbbcccc option controls _b_u_g _c_o_m_p_a_t_i_b_i_l_i_t_y mode in the
  46.                   server, if possible; a preceding dash(-) disables
  47.                   the mode, otherwise the mode is enabled.  Various
  48.                   pre-R4 clients pass illegal values in some protocol
  49.                   requests, and pre-R4 servers did not correctly
  50.                   generate errors in these cases.  Such clients, when
  51.                   run against an R4 server, will terminate abnormally
  52.                   or otherwise fail to operate correctly.  Bug
  53.                   compatibility mode explicitly reintroduces certain
  54.                   bugs into the X server, so that many such clients
  55.                   can still be run.  This mode should be used with
  56.                   care; new application development should be done
  57.                   with this mode disabled.  The server must support
  58.                   the MIT-SUNDRY-NONSTANDARD protocol extension in
  59.                   order for this option to work.
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 4/30/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXSSSSEEEETTTT((((1111))))            XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....3333))))             XXXXSSSSEEEETTTT((((1111))))
  71.  
  72.  
  73.  
  74.           cccc       The cccc option controls key click.  This option can
  75.                   take an optional value, a preceding dash(-), or an
  76.                   'on/off' flag.  If no parameter or the 'on' flag is
  77.                   given, the system defaults will be used. If the dash
  78.                   or 'off' flag is used, keyclick will be disabled.
  79.                   If a value from 0 to 100 is given, it is used to
  80.                   indicate volume, as a percentage of the maximum.
  81.                   The X server will set the volume to the nearest
  82.                   value that the hardware can support.
  83.  
  84.           ffffpppp==== _p_a_t_h,...
  85.                   The ffffpppp==== sets the font path to the entries given in
  86.                   the path argument.  The entries are interpreted by
  87.                   the server, not by the client.  Typically they are
  88.                   directory names or font server names, but the
  89.                   interpretation is server-dependent.
  90.  
  91.           ffffpppp ddddeeeeffffaaaauuuulllltttt
  92.                   The ddddeeeeffffaaaauuuulllltttt argument causes the font path to be
  93.                   reset to the server's default.
  94.  
  95.           ffffpppp rrrreeeehhhhaaaasssshhhh
  96.                   The rrrreeeehhhhaaaasssshhhh argument resets the font path to its
  97.                   current value, causing the server to reread the font
  98.                   databases in the current font path.  This is
  99.                   generally only used when adding new fonts to a font
  100.                   directory (after running _m_k_f_o_n_t_d_i_r to recreate the
  101.                   font database).
  102.  
  103.           ----ffffpppp or ffffpppp----
  104.                   The ----ffffpppp and ffffpppp---- options remove elements from the
  105.                   current font path.  They must be followed by a
  106.                   comma-separated list of entries.
  107.  
  108.           ++++ffffpppp or ffffpppp++++
  109.                   This ++++ffffpppp and ffffpppp++++ options prepend and append elements
  110.                   to the current font path, respectively.  They must
  111.                   be followed by a comma-separated list of entries.
  112.  
  113.           lllleeeedddd     The lllleeeedddd option controls the keyboard LEDs.  This
  114.                   controls the turning on or off of one or all of the
  115.                   LEDs.  It accepts an optional integer, a preceding
  116.                   dash(-) or an 'on/off' flag.  If no parameter or the
  117.                   'on' flag is given, all LEDs are turned on.  If a
  118.                   preceding dash or the flag 'off' is given, all LEDs
  119.                   are turned off.  If a value between 1 and 32 is
  120.                   given, that LED will be turned on or off depending
  121.                   on the existence of a preceding dash.  A common LED
  122.                   which can be controlled is the ``Caps Lock'' LED.
  123.                   ``xset led 3'' would turn led #3 on.  ``xset -led
  124.                   3'' would turn it off.  The particular LED values
  125.                   may refer to different LEDs on different hardware.
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 4/30/98)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      XXXXSSSSEEEETTTT((((1111))))            XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....3333))))             XXXXSSSSEEEETTTT((((1111))))
  137.  
  138.  
  139.  
  140.                   Standard SGI keyboards use led #5 for the ``Caps
  141.                   Lock`` indicator, #6 for the ``Num Lock`` indicator
  142.                   and #7 for the ``Scroll Lock`` indicator.
  143.  
  144.                   NOTE: As of X11R6.1 (shipped in IRIX 6.2), the X
  145.                   Keyboard (XKB) Extension owns the indicators and the
  146.                   core X protocol LED controls are not guaranteed to
  147.                   work (XKB adds programmable indicators and ways to
  148.                   disable explicit control of indicators).
  149.  
  150.           mmmm       The mmmm option controls the mouse parameters.  The
  151.                   parameters for the mouse are `acceleration' and
  152.                   `threshold'.  The acceleration can be specified as
  153.                   an integer, or as a simple fraction.  The mouse, or
  154.                   whatever pointer the machine is connected to, will
  155.                   go `acceleration' times as fast when it travels more
  156.                   than `threshold' pixels in a short time.  This way,
  157.                   the mouse can be used for precise alignment when it
  158.                   is moved slowly, yet it can be set to travel across
  159.                   the screen in a flick of the wrist when desired.
  160.                   One or both parameters for the mmmm option can be
  161.                   omitted, but if only one is given, it will be
  162.                   interpreted as the acceleration.  If no parameters
  163.                   or the flag 'default' is used, the system defaults
  164.                   will be set.
  165.  
  166.           pppp       The pppp option controls pixel color values.  The
  167.                   parameters are the color map entry number in
  168.                   decimal, and a color specification.  The root
  169.                   background colors may be changed on some servers by
  170.                   altering the entries for BlackPixel and WhitePixel.
  171.                   Although these are often 0 and 1, they need not be.
  172.                   Also, a server may choose to allocate those colors
  173.                   privately, in which case an error will be generated.
  174.                   The map entry must not be a read-only color, or an
  175.                   error will result.
  176.  
  177.           rrrr       The rrrr option controls the autorepeat.  If a
  178.                   preceding dash or the 'off' flag is used, autorepeat
  179.                   will be disabled.  If no parameters or the 'on' flag
  180.                   is used, autorepeat will be enabled.  If a specific
  181.                   keycode is specified as a parameter, autorepeat for
  182.                   that keycode is enabled or disabled.
  183.  
  184.           ssss       The ssss option lets you set the screen saver
  185.                   parameters.  This option accepts up to two numerical
  186.                   parameters, a 'blank/noblank' flag, an
  187.                   'expose/noexpose' flag, an 'on/off' flag, an
  188.                   'activate/reset' flag, or the 'default' flag.  If no
  189.                   parameters or the 'default' flag is used, the system
  190.                   will be set to its default screen saver
  191.                   characteristics.  The 'on/off' flags simply turn the
  192.  
  193.  
  194.  
  195.      Page 3                                          (printed 4/30/98)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      XXXXSSSSEEEETTTT((((1111))))            XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....3333))))             XXXXSSSSEEEETTTT((((1111))))
  203.  
  204.  
  205.  
  206.                   screen saver functions on or off.  The 'activate'
  207.                   flag forces activation of screen saver even if the
  208.                   screen saver had been turned off.  The 'reset' flag
  209.                   forces deactivation of screen saver if it is active.
  210.                   The 'blank' flag sets the preference to blank the
  211.                   video (if the hardware can do so) rather than
  212.                   display a background pattern, while 'noblank' sets
  213.                   the preference to display a pattern rather than
  214.                   blank the video.  The 'expose' flag sets the
  215.                   preference to allow window exposures (the server can
  216.                   freely discard window contents), while 'noexpose'
  217.                   sets the preference to disable screen saver unless
  218.                   the server can regenerate the screens without
  219.                   causing exposure events.  The length and period
  220.                   parameters for the screen saver function determines
  221.                   how long the server must be inactive for screen
  222.                   saving to activate, and the period to change the
  223.                   background pattern to avoid burn in.  The arguments
  224.                   are specified in seconds.  If only one numerical
  225.                   parameter is given, it will be used for the length.
  226.  
  227.                   NOTE: some SGI systems and monitors support a
  228.                   monitor power-save option, which allows the monitor
  229.                   to use less current when turned on, but not in use.
  230.                   This feature is controlled through the screen saver
  231.                   interval. To check whether your system supports the
  232.                   feature, set the screen saver interval to its
  233.                   default, by using 'xset s default', then read back
  234.                   the default interval using 'xset q'.  If the default
  235.                   interval is 0, the system supports the feature. To
  236.                   enable the feature, set the interval to a non-zero
  237.                   value, which will be the number of seconds between
  238.                   the time screen saving is enabled and the time
  239.                   monitor power-save is turned on. A value of 0
  240.                   disables monitor power-save. If 'noblank' is
  241.                   enabled, the screen saver interval reverts to its
  242.                   original meaning, i.e., the period to change the
  243.                   background pattern.
  244.  
  245.           qqqq       The qqqq option gives you information on the current
  246.                   settings.
  247.  
  248.           These settings will be reset to default values when you log
  249.           out.
  250.  
  251.           Note that not all X implementations are guaranteed to honor
  252.           all of these options.
  253.  
  254.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  255.           X(1), Xserver(1), xmodmap(1), xrdb(1), xsetroot(1)
  256.  
  257.      AAAAUUUUTTTTHHHHOOOORRRR
  258.  
  259.  
  260.  
  261.      PPPPaaaaggggeeee 4444                                          ((((pppprrrriiiinnnntttteeeedddd 4444////33330000////99998888))))
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.      XXXXSSSSEEEETTTT((((1111))))            XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....3333))))             XXXXSSSSEEEETTTT((((1111))))
  269.  
  270.  
  271.  
  272.           Bob Scheifler, MIT Laboratory for Computer Science
  273.           David Krikorian, MIT Project Athena (X11 version)
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.      Page 5                                          (printed 4/30/98)
  328.  
  329.  
  330.  
  331.